home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / spitfire / sfss20.zip / SFSS.DOC < prev    next >
Text File  |  1996-05-22  |  6KB  |  153 lines

  1. ╔══════════════════════════════════════════════════════════════════════════════╗
  2. ║ Spitfire System Statistics (SFSS)                                       v2.0 ║
  3. ╚══════════════════════════════════════════════════════════════════════════════╝
  4. ╔══════════════════════════════════════════════════════════════════════════════╗
  5. ║ Ross Cassell Of Cornerware Utilities (C) Copyright 1996 All Rights Reserved. ║
  6. ╚══════════════════════════════════════════════════════════════════════════════╝
  7. ╔══════════════╗
  8. ║ Introduction ║
  9. ╚══════════════╝
  10. Another System Statistics Reporting Utility..<g>. Yeah I know, we have tons
  11. of them out there, but hey, this is FREEWARE!! SFSS, is a small but fast
  12. utility that will create a Spitfire Display Screen showing the caller 18
  13. little tidbits of info pertaining to them and your BBS, it may interest
  14. them, but again it may not!! SFSS is intended and designed to run in either
  15. the SFLOGON.BAT or a SFSEC###.BAT file, which are executed by Spitfire when
  16. a caller logs on.
  17.  
  18. ╔══════════╗
  19. ║ Features ║
  20. ╚══════════╝
  21. ■ Fast execution, your callers would be none the wiser that you just ran a
  22.   utility that read in SFDOORS.DAT/SFNODE.DAT and SFSYSTEM.DAT and then
  23.   wrote 2 display screens. Makes *.BBS and *.CLR.
  24.  
  25. ■ Reports Following Info:
  26.  
  27.   * Sysop Page Status
  28.   * Callers Baud Rate
  29.   * Callers Last File And Message Areas
  30.   * Callers Security Level
  31.   * Callers Allowable Downloads Per Day
  32.   * Callers Downloads That Day (So far)
  33.   * Callers Subscription Expire Date
  34.   * Callers Time Left In Minutes That Day
  35.   * Number Of Calls To System That Day
  36.   * Total Calls To System
  37.   * System Node Number And Total Nodes
  38.   * New Callers To System That Day
  39.   * Number Of Doors Ran That Day
  40.   * Uploads To System That Day
  41.   * Downloads From System That Day
  42.   * Messages Entered Online That Day
  43.  
  44. ■ You the sysop can configure the color of the output ANSI file (*.CLR)
  45.  
  46. ■ Its FREEWARE! What more do you want..<g>
  47.  
  48. ╔═════════════════╗
  49. ║ Setup And Usage ║
  50. ╚═════════════════╝
  51. Ok, so you downloaded this utility from your favorite Spitfire Support BBS
  52. or received it from some other method, you want to see what the screens
  53. look like that this program produces? Well included in this package are:
  54.  
  55. SFSS.CLR
  56. SFSS.BBS
  57.  
  58. These are samples for your perusal, SFSS.CLR is the ANSI screen and
  59. SFSS.BBS is the ASCII screen.
  60.  
  61. Lets get started:
  62.  
  63. [1] Unzip the executable and sample SFSS.CFG file into your Spitfire home
  64.     directory.
  65.  
  66. [2] SFSS relies on an environmental variable in order to properly find your
  67.     Spitfire data files, this variable is widely used by a vast majority of
  68.     utilities authored by Spitfires author and other third party authors
  69.     such as myself..:) Take a peek into your AUTOEXEC.BAT file and look for
  70.     this statement:
  71.  
  72.     SET SFPATH=DRIVE:\PATHTOSPITFIRE
  73.  
  74.     Where PATHTOSPITFIRE would represent the correct path to where you have
  75.     the SPITFIRE.EXE and SPITFIRE.OVR files, therefore if your Spitfire
  76.     Home directory is C:\SF then your SET statement in AUTOEXEC.BAT would
  77.     look like this:
  78.  
  79.     SET SFPATH=C:\SF
  80.  
  81.     If you already have this statement, proceed to step 3, if you had to
  82.     add or modify this statement, make those changes, reboot your system
  83.     and then proceed to step 3.
  84.  
  85.     If the SFPATH environmental is not present or incorrectly setup, SFSS
  86.     will complain, refuse to run and nothing happens..
  87.  
  88. [3] I thought deeply about including the configuration file info into this
  89.     documentation but decided to document it in the enclosed sample, so
  90.     your next step is to create your cfg file, my suggestion to you is to
  91.     print it out and then load it into your favorite text editor.
  92.  
  93.     Some rules on the cfg file:
  94.  
  95.     [A] The CFG file must be called SFSS.CFG!
  96.  
  97.     [B] SFSS.CFG must exist within the same directory or SFSS will complain
  98.         and nothing happens.. This also means that SFSS.CFG must exist
  99.         period..
  100.  
  101.     [C] It must be setup exactly as documented in the sample or the
  102.         resulting display screens will probably not look right?
  103.         (Especially true for the ANSI screen)
  104.  
  105. [4] For SFSS to have the appropriate effects, you must run SFSS in one of
  106.     the batch files that Spitfire runs at logon, that would be SFLOGON.BAT
  107.     or SFSEC###.BAT (Where ### would represent a security level),
  108.     SFLOGON.BAT is the preferable method. Execution of SFSS is simple:
  109.  
  110.     Example:
  111.  
  112.     @ECHO OFF
  113.     CD\SF
  114.     SFSS
  115.  
  116.     SFSS does not recognize or require any command line parameters, it will
  117.     do its thing provided that the afore mentioned environmental variable
  118.     is set and that it can find SFSS.CFG, one further consideration is that
  119.     since it reads in SFDOORS.DAT, it wont do anything until SFDOORS.DAT is
  120.     present. (Hence why it must be run at logon, as Spitfire creates a
  121.     SFDOORS.DAT file when shelling to SFLOGON.BAT or SFSEC###.BAT.)
  122.  
  123. ╔═════════════════════════╗
  124. ║ Warranty And Disclaimer ║
  125. ╚═════════════════════════╝
  126. SFSS comes with no warranty expressed or implied, use it at your own risk.
  127.  
  128. ╔══════════════╗
  129. ║ Registration ║  
  130. ╚══════════════╝  
  131. SFSS is released as FREEWARE, although I retain rights to the program and
  132. its source code, if you feel a monetary donation is necessary, then please
  133. donate what you can to your favorite charity.
  134.  
  135. ╔══════════════════════════════╗
  136. ║ Credits And Acknowledgements ║
  137. ╚══════════════════════════════╝
  138. SFSS is (C) Copyright 1996 by Ross Cassell Of Cornerware Utilities.
  139. Spitfire is (C) Copyright by Mike Woltz Of Buffalo Creek Software.
  140. Turbo Pascal v7.0 is (C) Copyright of Borland International.
  141.  
  142. ╔═════════╗
  143. ║ Support ║
  144. ╚═════════╝
  145.  
  146. Ross Cassell
  147. The Dark Corner BBS
  148. 1-864-573-7069
  149. INTERNET: rcassell@worldnet.att.net
  150.  FIDONET: 1:3652/1
  151.    SFNET: A0864000
  152.  
  153.